---
title: 知识库管理与文档维护
version: '简体中文'
---

## 知识库管理

> 知识库管理页仅面向团队所有者、团队管理员、编辑权限角色开放。

在 Dify 团队首页中，点击顶部的 “知识库” tab 页，选择需要管理的知识库，轻点左侧导航中的**设置**进行调整。你可以调整知识库名称、描述、可见权限、索引模式、Embedding 模型和检索设置。

<Frame caption="知识库设置">
  <img src="/zh-hans/user-guide/.gitbook/assets/image (8).png" alt="" />
</Frame>

**知识库名称**，用于区分不同的知识库。

**知识库描述**，用于描述知识库内文档代表的信息。

**可见权限**，提供 **「 只有我 」** 、 **「 所有团队成员 」** 和 **「部分团队成员」** 三种权限范围。不具有权限的人将无法访问该知识库。若选择将知识库公开至其它成员，则意味着其它成员同样具备该知识库的查看、编辑和删除权限。

**索引模式**，详细说明请[参考文档](/zh-hans/guides/knowledge-base/knowledge-base-creation/introduction)。

**Embedding 模型**， 修改知识库的嵌入模型，修改 Embedding 模型将对知识库内的所有文档重新嵌入，原先的嵌入将会被删除。

**检索设置**，详细说明请[参考文档](/zh-hans/guides/knowledge-base/knowledge-base-creation/introduction)。

***

### 使用 API 维护知识库

Dify 知识库提供整套标准 API ，开发者通过 API 调用对知识库内的文档、分段进行增删改查等日常管理维护操作，请参考[知识库 API 文档](/zh-hans/guides/knowledge-base/knowledge-and-documents-maintenance/maintain-dataset-via-api)。

<Frame caption="知识库 API 管理">
  <img src="/zh-hans/user-guide/.gitbook/assets/image (231).png" alt="" />
</Frame>

## 维护知识库中的文本

### 添加文档

知识库（Knowledge）是一些文档（Documents）的集合。文档可以由开发者或运营人员上传，或由同步其它数据源（对应数据源中的一个文件单位，例如 Notion 库内的一篇文档或新的在线文档网页）。

点击 「知识库」 > 「文档列表 ，然后轻点 「 添加文件 」，即可在已创建的知识库内上传新的文档。

<Frame caption="在知识库内上传新文档">
  <img src="/zh-hans/user-guide/.gitbook/assets/image (10).png" alt="" />
</Frame>

***

### 禁用或归档文档

**禁用**：数据集支持将暂时不想被索引的文档或分段进行禁用，在数据集文档列表，点击禁用按钮，则文档被禁用；也可以在文档详情，点击禁用按钮，禁用整个文档或某个分段，禁用的文档将不会被索引。禁用的文档点击启用，可以取消禁用。

**归档**：一些不再使用的旧文档数据，如果不想删除可以将它进行归档，归档后的数据就只能查看或删除，不可以进行编辑。在数据集文档列表，点击归档按钮，则文档被归档，也可以在文档详情，归档文档。归档的文档将不会被索引。归档的文档也可以点击撤销归档。

***

### 查看文本分段

知识库内已上传的每个文档都会以文本分段（Chunks）的形式进行存储，你可以在分段列表内查看每一个分段的具体文本内容。

<Frame caption="查看已上传的文档分段">
  <img src="/zh-hans/user-guide/.gitbook/assets/image (88).png" alt="" />
</Frame>

***

### 检查分段质量

文档分段对于知识库应用的问答效果有明显影响，在将知识库与应用关联之前，建议人工检查分段质量。

通过字符长度、标识符或者 NLP 语义分段等机器自动化的分段方式虽然能够显著减少大规模文本分段的工作量，但分段质量与不同文档格式的文本结构、前后文的语义联系都有关系，通过人工检查和订正可以有效弥补机器分段在语义识别方面的缺点。

检查分段质量时，一般需要关注以下几种情况：

* **过短的文本分段**，导致语义缺失；

<Frame caption="过短的文本分段">
  <img src="/zh-hans/user-guide/.gitbook/assets/image (234).png" alt="" width="373" />
</Frame>

* **过长的文本分段**，导致语义噪音影响匹配准确性；

<Frame caption="过长的文本分段">
  <img src="/zh-hans/user-guide/.gitbook/assets/image (237).png" alt="" width="375" />
</Frame>

* **明显的语义截断**，在使用最大分段长度限制时会出现强制性的语义截断，导致召回时缺失内容；

<Frame caption="明显的语义截断">
  <img src="/zh-hans/user-guide/.gitbook/assets/image (236).png" alt="" width="357" />
</Frame>

***

### 添加文本分段

在分段列表内点击 「 添加分段 」 ，可以在文档内自行添加一个或批量添加多个自定义分段。

<Frame caption="">
  <img src="/zh-hans/user-guide/.gitbook/assets/image (90).png" alt="" />
</Frame>

批量添加分段时，你需要先下载 CSV 格式的分段上传模板，并按照模板格式在 Excel 内编辑所有的分段内容，再将 CSV 文件保存后上传。

<Frame caption="批量添加自定义分段">
  <img src="/zh-hans/user-guide/.gitbook/assets/image (92).png" alt="" />
</Frame>

***

### 编辑文本分段

在分段列表内，你可以对已添加的分段内容直接进行编辑修改。包括分段的文本内容和关键词。

<Frame caption="编辑文档分段">
  <img src="/zh-hans/user-guide/.gitbook/assets/image (93).png" alt="" />
</Frame>

***

### 元数据管理

除了用于标记不同来源文档的元数据信息，例如网页数据的标题、网址、关键词、描述等。元数据将被用于知识库的分段召回过程中，作为结构化字段参与召回过滤或者显示引用来源。

<Info>
  元数据过滤及引用来源功能当前版本尚未支持。
</Info>

<Frame caption="元数据管理">
  <img src="/zh-hans/user-guide/.gitbook/assets/image (230).png" alt="" />
</Frame>

{/*
Contributing Section
DO NOT edit this section!
It will be automatically generated by the script.
*/}

<CardGroup cols="2">
    <Card
        title="编辑此页面"
        icon="pen-to-square"
        href="https://github.com/langgenius/dify-docs-mintlify/edit/main/zh-hans/guides/knowledge-base/knowledge-and-documents-maintenance.mdx"
    >
        通过直接提交修改来帮助改进文档内容
    </Card>
    <Card
        title="提交问题"
        icon="github"
        href="https://github.com/langgenius/dify-docs-mintlify/issues/new?title=文档问题%3A%20edge-and-documents-maintena&body=%23%23%20问题描述%0A%3C%21--%20请简要描述您发现的问题%20--%3E%0A%0A%23%23%20页面链接%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs-mintlify%2Fblob%2Fmain%2Fzh-hans/guides/knowledge-base%2Fknowledge-and-documents-maintenance.mdx%0A%0A%23%23%20建议修改%0A%3C%21--%20如果有具体的修改建议，请在此说明%20--%3E%0A%0A%3C%21--%20感谢您对文档质量的关注！%20--%3E"
    >
        发现错误或有改进建议？请提交问题反馈
    </Card>
</CardGroup>
